home *** CD-ROM | disk | FTP | other *** search
/ Tech Arsenal 1 / Tech Arsenal (Arsenal Computer).ISO / tek-15 / scope14b.zip / MANUAL.TXT < prev    next >
Text File  |  1991-08-15  |  98KB  |  2,285 lines

  1.  
  2.  
  3.  
  4.  
  5.  
  6.  
  7.  
  8.  
  9.         DDDDD                     SSSSS
  10.          D   D  aaa    t    aaa  S        ccc   ooo   ppp   eee   TM
  11.          D   D     a ttttt     a  SS     c     o   o p   p e   e
  12.          D   D  aaaa   t    aaaa    SS   c     o   o p   p eeee
  13.          D   D a   a   t   a   a      S  c     o   o p   p e
  14.         DDDDD   aaa     tt  aaa  SSSSS    ccc   ooo  pppp   eee
  15.                                                      p
  16.                                                      p
  17.                                                      p
  18.                                                      p
  19.  
  20.         User's Reference                                    August, 1991
  21.  
  22.  
  23.  
  24.  
  25.  
  26.  
  27.  
  28.  
  29.  
  30.  
  31.  
  32.  
  33.  
  34.  
  35.                                         Protocol Analyzer and Line Scope
  36.                                         -        -            -    -
  37.  
  38.  
  39.  
  40.  
  41.  
  42.  
  43.  
  44.  
  45.  
  46.  
  47.  
  48.  
  49.  
  50.                                           Paladin Software, Incorporated
  51.  
  52.         Introduction
  53.         ________________________________________________________________
  54.  
  55.  
  56.                               _______
  57.                          ____|__     |               (tm)
  58.                       --|       |    |-------------------
  59.                         |   ____|__  |  Association of
  60.                         |  |       |_|  Shareware
  61.                         |__|   o   |    Professionals
  62.                       -----|   |   |---------------------
  63.                            |___|___|    MEMBER
  64.  
  65.  
  66.  
  67.         The Shareware Concept
  68.         ---------------------
  69.  
  70.         DataScope is distributed on a Shareware basis. You may use
  71.         DataScope without charge for the purposes of evaluating it's
  72.         usefulness and suitability to task. If you find DataScope
  73.         worthwhile, then you should order a registered version of the
  74.         program. Registered copies of the program do not display
  75.         registration reminders and come with a detailed 130 page
  76.         user's manual, monitor cables and two serial connectors. An
  77.         order form is already prepared in ORDERFRM.DOC - simply print
  78.         this file, supply the necessary information and mail it in to us
  79.         with your payment. An invoice will be shipped automatically with
  80.         your order.
  81.  
  82.         DataScope will soon have a protocol analysis language as well as
  83.         additional capabilities and enhancements, and as a registered
  84.         user you will be entitled to low cost upgrades to the newest
  85.         versions as soon as they are released. Most importantly however,
  86.         by registering your copy of DataScope (or any Shareware
  87.         product), you'll ensure the survival of the convenient and risk
  88.         free distribution method that originally brought you DataScope.
  89.  
  90.         If you have paid a small fee to a Users' Group, "Software
  91.         Library" or "SIG" to receive this copy, you have NOT acquired
  92.         the registered rights or continued right to use DataScope. This
  93.         fee was for the convenience of obtaining the DataScope diskette,
  94.         and cannot be applied toward the purchase of a registered copy.
  95.  
  96.         You may freely copy DataScope for distribution under the
  97.         Shareware concept, without charge. You may not reverse engineer,
  98.         decompile, or disassemble the software. You may not rent or
  99.         lease the software to other persons. You may not charge any fee
  100.         for the DataScope program or documentation without our express
  101.         written approval. Similarly, you may not distribute DataScope or
  102.         it's documentation in connection with any commercial venture,
  103.         product, publication or service without our express written
  104.         approval.
  105.  
  106.  
  107.                                        ii
  108.  
  109.                                                             Introduction
  110.         ________________________________________________________________
  111.  
  112.         Support Policy and Guarantee
  113.         ----------------------------
  114.  
  115.         When you purchase a registered version, you receive three months
  116.         of unlimited telephone support. Support hours are from 9 AM to 5
  117.         PM PST. DataScope also comes with a 90 day money back guarantee:
  118.         If for any reason you are unsatisfied, you may return all
  119.         materials for an immediate refund of the full purchase price.
  120.  
  121.  
  122.         Warranty Disclaimer
  123.         -------------------
  124.  
  125.         DataScope is supplied as is. Paladin Software, Inc. disclaims
  126.         all warranties, expressed or implied with respect to the
  127.         software and documentation, including but not limited to implied
  128.         warranties of merchantability and fitness for a particular
  129.         purpose.
  130.  
  131.  
  132.         Liability Limitations
  133.         ---------------------
  134.  
  135.         Under no circumstances shall Paladin Software, Inc. be liable
  136.         for any damages whatsoever, including special, incidental,
  137.         consequential, indirect or other similar damages arising out of
  138.         the use or inability to use this product, even if Paladin
  139.         Software, Inc. has been advised of the possibility of such
  140.         damages.
  141.  
  142.  
  143.         Copyright and Trademark Notices
  144.         -------------------------------
  145.  
  146.         Copyright 1990-1991, Paladin Software, Incorporated. All rights
  147.         reserved.
  148.  
  149.         Information in the documentation is subject to change without
  150.         notice and does not constitute a commitment on the part of
  151.         Paladin Software, Inc.
  152.  
  153.         DataScope and Modulink are trademarks of Paladin Software, Inc.
  154.         AutoMate is a trademark of ComTek Corp. BreakOut-II is a
  155.         trademark of Advanced Firmware Engineering. Serialtest is a
  156.         trademark of Advanced Computer Consulting, Incorporated. IBM,
  157.         PC, XT, AT, and PS/2 are registered trademarks of International
  158.         Business Machines Corporation.
  159.  
  160.  
  161.  
  162.  
  163.  
  164.                                       iii
  165.  
  166.  
  167.  
  168.                             TABLE OF CONTENTS
  169.                             -----------------
  170.  
  171.  
  172.         Using This Manual.............................................vi
  173.         Introducing DataScope.........................................vi
  174.         Typographical Conventions...................................viii
  175.  
  176.         CHAPTER ONE - INSTALLATION AND STARTUP
  177.  
  178.         What You Need................................................1-1
  179.         Installation.................................................1-1
  180.                 Floppy Disk Systems..................................1-1
  181.                 Hard Disk Systems....................................1-2
  182.         Starting DataScope...........................................1-2
  183.  
  184.         CHAPTER TWO - CONFIGURATION
  185.  
  186.         Startup Options..............................................2-1
  187.                 Interrupt Switch.....................................2-1
  188.                 Configurations Switch................................2-2
  189.         Platform Setup...............................................2-2
  190.                 The DOS Search Path..................................2-2
  191.                 The Environment Variable PALS........................2-4
  192.                 Your AUTOEXEC.BAT Contents...........................2-4
  193.                 Your CONFIG.SYS Contents.............................2-5
  194.         Serial Port Cabling..........................................2-5
  195.                 Modulink Cables......................................2-5
  196.                         RS-232 Cable Tap (Monitor Modes).............2-6
  197.                         AutoMate RJ-45 Cable Tap (Monitor Modes).....2-6
  198.                 Interactive Cables...................................2-7
  199.                 Shareware Cables.....................................2-8
  200.  
  201.         CHAPTER THREE - SETUP BASICS
  202.  
  203.         DataScope Hot Keys...........................................3-1
  204.                 Hot Key Execution....................................3-1
  205.                 Hot Key Mnemonics....................................3-3
  206.                         Setup Screen Hot Keys........................3-3
  207.                         Modal Hot Keys...............................3-3
  208.                         Function Hot Keys............................3-4
  209.         DataScope Menus..............................................3-4
  210.                 Exiting DataScope....................................3-5
  211.                         Quit Menu Selection..........................3-5
  212.                         Control-C Hot Key Option.....................3-6
  213.  
  214.  
  215.  
  216.  
  217.  
  218.  
  219.  
  220.  
  221.                                       iv
  222.  
  223.                                                        Table of Contents
  224.         ________________________________________________________________
  225.  
  226.  
  227.         Setup Screen Field Editing...................................3-6
  228.                 Field Selection......................................3-7
  229.                 Field Entry Methods..................................3-7
  230.                         Predefined Lists.............................3-8
  231.                         Alphanumeric Strings.........................3-8
  232.                         Numeric Strings..............................3-8
  233.                         Hybrid Strings...............................3-8
  234.                 Port Specific Fields.................................3-9
  235.         Basic Setup List.............................................3-9
  236.                 Device Assignments..................................3-11
  237.  
  238.         CHAPTER FOUR - ADVANCED TOPICS
  239.  
  240.         Help.........................................................4-1
  241.         Live Displays................................................4-1
  242.         Capture Display..............................................4-1
  243.         History Display..............................................4-2
  244.                 History Function Keys................................4-2
  245.                         History Cursor Functions.....................4-2
  246.                         History Special Functions....................4-3
  247.                 History Menu Selections..............................4-4
  248.                         GoTo.........................................4-4
  249.                         Byte Scan....................................4-4
  250.                         String Match.................................4-5
  251.         Port Setup...................................................4-6
  252.         Vector Setup.................................................4-6
  253.         Archive Setup................................................4-7
  254.         Capture Setup................................................4-7
  255.         Data Archive.................................................4-8
  256.         Data Capture.................................................4-8
  257.         Translation String Editing...................................4-9
  258.                 Individual Attribute Changes.........................4-9
  259.                 Translation String Changes..........................4-10
  260.                 Global Attribute Changes............................4-10
  261.  
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268.  
  269.  
  270.  
  271.  
  272.  
  273.  
  274.  
  275.  
  276.  
  277.  
  278.                                        v
  279.  
  280.         Introduction
  281.         ________________________________________________________________
  282.  
  283.         Using This Manual
  284.         -----------------
  285.  
  286.         We have organized the manual to encourage immediate execution of
  287.         the software. Three introductory chapters provide increasing
  288.         levels of detail that allow you to read a minimum amount of
  289.         information before putting your newly acquired understanding to
  290.         work. These chapters have been written in plain language that
  291.         anyone can understand - no special expertise is required to
  292.         understand or install DataScope.
  293.  
  294.         The final chapter is organized topically. The heading names
  295.         identify the covered topic. Each topic is independent of the
  296.         other topics - they can be read separately, and in any order.
  297.  
  298.         Typically, people using communication analysis tools fall into
  299.         two categories: Those interested in debugging serial connections
  300.         to devices (such as modems, printers, plotters, and other
  301.         computers), and those interested in debugging or analyzing
  302.         serial protocols. Many advanced features of DataScope are
  303.         specifically designed to address protocol debugging issues.
  304.         Connection oriented users will want to concentrate more on the
  305.         live displays and the RS-232 signal information.
  306.  
  307.  
  308.         Introducing DataScope
  309.         ---------------------
  310.  
  311.         You have purchased the finest software line analyzer on the
  312.         market today. No other product can match the features, user
  313.         interface, data collection efficiency, or display capabilities
  314.         of DataScope. The salient features of this landmark product are
  315.         listed below.
  316.  
  317.                               DataScope Features
  318.                               ------------------
  319.  
  320.         o STANDARD BAUD RATES UP TO 115,200 BITS PER SECOND. Predefined,
  321.         convenient standard baud rates are supported to speed selection
  322.         for the typical communication rates used by most computers and
  323.         peripherals.
  324.  
  325.         o USER DEFINABLE BAUD RATES. For situations that require unusual
  326.         baud rates, a user definable baud rate field is provided to
  327.         allow all possible baud rates (selected rates must be proper
  328.         divisions of the crystal frequency) with automatic nearest true
  329.         rate adjustment.
  330.  
  331.  
  332.  
  333.  
  334.  
  335.                                        vi
  336.  
  337.                                                             Introduction
  338.         ________________________________________________________________
  339.  
  340.         o FULL CAPTURE MODE TRIGGER POSITIONING CONTROL. Capturing
  341.         specific items of interest is easy with the powerful
  342.         alphanumeric string detection and occurrence counting
  343.         capabilities. In conjunction with the archive control
  344.         techniques, full trigger position control can be achieved.
  345.  
  346.         o HISTORIC ARCHIVE STORAGE UP TO EIGHT MEGABYTES. You never have
  347.         to worry about lost data with the eight megabyte storage
  348.         capacity of the archive files.
  349.  
  350.         o DUAL HISTORY CURSORS WITH MICROSECOND TIMING RESOLUTION.
  351.         Character arrival timing resolution is actually better than one
  352.         microsecond! Two cursors are available with independent motion
  353.         control to allow timing comparisons across any number of bytes.
  354.  
  355.         o FULL ARCHIVE STORAGE PARAMETER CONTROL. Archive file storage
  356.         length, storage increment size, filename, path, and drive letter
  357.         are all user alterable. Archive files can be created, selected
  358.         and altered at will.
  359.  
  360.         o MULTIPLE LIVE, INTERACTIVE AND HISTORIC DATA VIEWS. Many live
  361.         display options are available to satisfy different usage
  362.         requirements, varying the source arrangements by line, character
  363.         and screen position. An historic data view allows analysis of
  364.         any archived data.
  365.  
  366.         o FULL SCREEN MAIN STATUS DISPLAY. You don't need to enter a
  367.         setup screen to determine what system settings you last chose.
  368.         The main status screen displays all major parameters organized
  369.         by related function.
  370.  
  371.         o USER CONFIGURATION FILE SETS. No need to memorize DataScope
  372.         setup parameters to analyze any particular device or
  373.         conversation. Once properly configured, simply save the current
  374.         configuration to a kernel file. Kernels can be recalled or
  375.         modified at any time.
  376.  
  377.         o UNLIMITED ALTERABLE CHARACTER AND ATTRIBUTE TRANSLATION SETS.
  378.         Display characters in Hex, Decimal or Octal using ASCII or
  379.         numeric data sets independently for each source! Every character
  380.         string of each data set is alterable - you can change
  381.         attributes, color or display string contents at any time. Data
  382.         sets are saved with the configuration kernels so you can have
  383.         different sets for different analysis purposes.
  384.  
  385.         o ON-LINE CONTEXT SENSITIVE HELP. One key combination summons
  386.         context sensitive help for the screen or field you are viewing.
  387.         The help file is longer than the application file!
  388.  
  389.  
  390.  
  391.  
  392.                                       vii
  393.  
  394.         Introduction
  395.         ________________________________________________________________
  396.  
  397.                      Full-featured archived data display
  398.                      -----------------------------------
  399.  
  400.         o DUAL TIMESTAMPED CURSORS. Each independent and movable cursor
  401.         is separately timestamped to allow accurate protocol analysis,
  402.         benchmarking and debugging. The delta difference between the two
  403.         cursor times is displayed as well.
  404.  
  405.         o TRUE BAUD RATE CALCULATION OF COM1, COM2 OR BOTH SOURCES. Line
  406.         usage can easily be determined at the touch of a function key.
  407.  
  408.         o ARCHIVE STORAGE OF OVER TEN DAYS OF RELATED DATA. Relative
  409.         timestamps are maintained accurately for over ten days (256
  410.         hours).
  411.  
  412.  
  413.                  Powerful, fast option and setup field editing
  414.                  ---------------------------------------------
  415.  
  416.         o THIRTEEN FIELD EDITING FUNCTION KEYS. Text field editing is
  417.         fully supported for fast and simple setup of the DataScope
  418.         options and parameters.
  419.  
  420.         o HOT KEY ACCESS TO ALL SETUP SCREENS FROM ALL PROGRAM MODES.
  421.         Fifteen mnemonically organized Hot keys provide instant setup
  422.         from any and all program modes.
  423.  
  424.         o AUTOMATIC CONTEXT SENSITIVE FIELD HELP FOR DATA ENTRY. Every
  425.         field automatically gives you related entry information when you
  426.         start editing the field. There is no need to memorize what
  427.         commands or data any particular field requires.
  428.  
  429.  
  430.         Typographical Conventions
  431.         -------------------------
  432.  
  433.         Field Name - Capitalization is used to identify setup screen
  434.                 field names.
  435.  
  436.         "Selection" - Quotes appear when the contents of a Field Name
  437.                 are specified.
  438.  
  439.         Hot-key - Hyphenations identify hot key combinations.
  440.  
  441.         mmmm  md pals  mmmm - Double spaces delimit commands that must
  442.                 be typed exactly as they appear in the text.
  443.  
  444.  
  445.  
  446.  
  447.  
  448.  
  449.                                      viii
  450.  
  451.  
  452.  
  453.                   CHAPTER ONE - INSTALLATION AND STARTUP
  454.                   --------------------------------------
  455.  
  456.  
  457.         Chapter one focuses totally upon DataScope installation and
  458.         startup, without any extraneous information. You should read
  459.         this chapter, even if you read nothing else. We encourage you to
  460.         run the program immediately - when you are ready for more
  461.         information, move on to the next chapter.
  462.  
  463.  
  464.         WHAT YOU NEED
  465.         -------------
  466.  
  467.         o Computer: IBM PC, XT, AT, or PS/2 computer or any 100% IBM
  468.         compatible clone.
  469.  
  470.         o Operating System: MS-DOS version 2.1 or above.
  471.  
  472.         o Memory: At least 192K of available ram is required.
  473.  
  474.         o Display: Monochrome, CGA, EGA, and VGA displays are all
  475.         supported.
  476.  
  477.         o Disk Drive: One floppy disk drive or one floppy disk drive and
  478.         any hard disk drive.
  479.  
  480.         o Serial Ports: One or two serial ports (two serial ports are
  481.         recommended, but not required).
  482.  
  483.         o Cables: One DataScope cable set (supplied with a registered
  484.         version of the software). You can make a simplified test cable
  485.         by following the diagram in the CABLE.DOC file.
  486.  
  487.  
  488.         INSTALLATION
  489.         ------------
  490.  
  491.         DataScope can run on floppy and hard disk based systems. The
  492.         absolute minimum knowledge of DOS command procedures is needed
  493.         (for those that don't know about DOS, and don't wish to learn,
  494.         the procedures are spelled out step-by-step).
  495.  
  496.  
  497.         Floppy Disk Systems
  498.         -------------------
  499.  
  500.         o Copy the executable and support files to a disk in the floppy
  501.         drive you wish to use for DataScope. All files without .DOC or
  502.         .TXT extensions are necessary for the successful operation of
  503.         DataScope.
  504.  
  505.  
  506.                                       1-1
  507.  
  508.         Installation and Startup
  509.         ________________________________________________________________
  510.  
  511.         Hard Disk Systems
  512.         -----------------
  513.  
  514.         o Create a directory for the application files using the DOS
  515.         command  md . For example, to create the directory PALS off of
  516.         the root directory, type  md\pals  and press Enter. You may
  517.         choose any name for the directory, and it may be at any level in
  518.         the directory tree structure.
  519.  
  520.         o Copy all application files to the hard disk drive directory
  521.         you just created. Application files have extensions other than
  522.         .DOC or .TXT to distinguish them from general information and
  523.         documentation files.
  524.  
  525.  
  526.         STARTING DATASCOPE
  527.         ------------------
  528.  
  529.         Before starting DataScope - even for just a first look - you
  530.         should make a backup copy of the DataScope distribution file and
  531.         (optionally) copy the files to your hard disk. Follow the
  532.         procedures outlined in Installing DataScope for the type of
  533.         system you have before starting DataScope as outlined below.
  534.  
  535.         o Change the current drive to the drive containing the DataScope
  536.         application files (type the drive letter, colon and press
  537.         Enter). For example, to make drive C the current drive type  c:
  538.         and press Enter.
  539.  
  540.         o Change the current directory to the directory containing the
  541.         DataScope application files (skip this step if you are operating
  542.         from a floppy disk based system - the application files are
  543.         normally in the root directory on floppy disk based systems).
  544.         Type  cd  followed by the full path specification of the
  545.         directory chosen in the installation of the DataScope files. If
  546.         you chose the example directory you would type  cd\pals  to
  547.         select the proper directory.
  548.  
  549.         o Type  pals  and press Enter to start DataScope. The DataScope
  550.         welcome screen will appear with the logo, version number,
  551.         revision date, and corporate address.
  552.  
  553.         o Press any key to exit the welcome screen and initiate the
  554.         application, displaying the main status screen.
  555.  
  556.  
  557.  
  558.  
  559.  
  560.  
  561.  
  562.  
  563.                                       1-2
  564.  
  565.  
  566.  
  567.                        CHAPTER TWO - CONFIGURATION
  568.                        ---------------------------
  569.  
  570.  
  571.         Chapters one through three are designed to be read in sequence -
  572.         be sure to read chapter one before continuing. You should have
  573.         already installed DataScope and created a backup of the
  574.         distribution file.
  575.  
  576.         We encourage you to take a look at DataScope now. Execute menu
  577.         commands. Look at setup screens and displays. Try to figure out
  578.         how the user interface operates and what the fields in the
  579.         status screen mean. Of course, all of these things are explained
  580.         in the on-line help and in the manual, but it will surely help
  581.         your understanding if you have at least seen the various aspects
  582.         of the interface before it is explained.
  583.  
  584.  
  585.         STARTUP OPTIONS
  586.         ---------------
  587.  
  588.         Two file argument switches are provided to modify DataScope's
  589.         startup actions. These special features should not be important
  590.         unless you attempt to change the port base addresses or
  591.         interrupt vectors from the default configuration settings - and
  592.         then only if you err in a disastrous way. You can probably skip
  593.         this information until seeking to become a "power user."
  594.  
  595.  
  596.         Interrupt Switch
  597.         ----------------
  598.  
  599.         Execute ...     To ...
  600.  
  601.         pals /i         Start DataScope with serial interrupts disabled.
  602.  
  603.                         This switch allows recovery from an incorrect
  604.                         and fatal specification of communication port
  605.                         base address or interrupt vector. Power-up with
  606.                         this switch to override the last vector
  607.                         installations and disable the serial interrupts.
  608.                         You must re-edit the incorrect specification
  609.                         that caused the system to crash or otherwise
  610.                         malfunction - only the interrupt vector
  611.                         installation is overridden by this switch.
  612.  
  613.  
  614.  
  615.  
  616.  
  617.  
  618.  
  619.  
  620.                                       2-1
  621.  
  622.         Configuration
  623.         ________________________________________________________________
  624.  
  625.         Configuration Switch
  626.         --------------------
  627.  
  628.         Execute ...        To ...
  629.  
  630.         pals /c filename    Start DataScope with a specific
  631.                             configuration kernel.
  632.  
  633.                             Use this switch to override DataScope's use
  634.                             of the most recent configuration kernel. The
  635.                             filename specified can follow the /c switch
  636.                             with or without a space or spaces, but must
  637.                             specify a real configuration file. If you do
  638.                             not include an extension, DataScope will
  639.                             append the default .CFG extension. This
  640.                             feature can save time when using multiple
  641.                             configurations and in automated startup
  642.                             procedures, or save your bacon if an ex-
  643.                             ternal program or event trashes your usual
  644.                             configuration file.
  645.  
  646.  
  647.         PLATFORM SETUP
  648.         --------------
  649.  
  650.         DataScope is intended to function as a high performance serial
  651.         analysis tool. Equally important, however, is a facile user
  652.         interface. To increase user friendliness, DataScope can take
  653.         advantage of two unique capabilities available in MS-DOS - the
  654.         search path and environment variables.
  655.  
  656.         To optimize performance of your applications, it is advisable to
  657.         have certain parameters set to certain values in your power-up
  658.         files. Both AUTOEXEC.BAT and CONFIG.SYS parameters will be
  659.         discussed.
  660.  
  661.  
  662.         The DOS Search Path
  663.         -------------------
  664.  
  665.         Most users are familiar with the terse DOS message "Bad command
  666.         or file name" that appears whenever one tries to execute a file
  667.         not in the DOS search path. The remedy for this, other than
  668.         always changing to the directory that contains the file before
  669.         executing it, is relatively simple. All directories in common
  670.         use can be included in the DOS search path. The PATH variable is
  671.         set in your AUTOEXEC.BAT file, and can be modified to contain
  672.         the directory you have created to hold the DataScope executive
  673.         file. Thus, executing  pals  will initiate DataScope regardless
  674.         of the current directory.
  675.  
  676.  
  677.                                       2-2
  678.  
  679.                                                            Configuration
  680.         ________________________________________________________________
  681.  
  682.         To continue our example (for those unfamiliar with what a path
  683.         string should look like), you could set your path as shown here:
  684.  
  685.                         set path=c:\;c:\dos;c:\pals
  686.  
  687.         Use of the  c:  drive specifier is neither required nor
  688.         necessary, unless you utilize multiple logical or physical
  689.         drives.
  690.  
  691.         Take heed of one caveat before you implement this capability and
  692.         blithely execute  pals  from each and every directory in
  693.         existence. DataScope expects to find at least one - and as many
  694.         as three - ancillary files in the current directory (the number
  695.         depends upon the existence of archive and/or configuration path
  696.         specifications) unless the environment variable PALS is set
  697.         (read the next section to learn about PALS).
  698.  
  699.         DataScope will happily run without two of these files (PALS.HLP
  700.         and the current, user specified archive file) but REQUIRES the
  701.         presence of a user specified configuration file or the PALS.CFG
  702.         default. This is a relatively complex subject and is only
  703.         covered in detail in the bound manual that comes with registered
  704.         copies of DataScope.
  705.  
  706.         Of course, nothing disastrous will happen if you execute  pals
  707.         in a directory that does not contain the proper ancillary files.
  708.         If the configuration file cannot be found within a six stage
  709.         search sequence, DataScope automatically returns to the DOS
  710.         prompt, refusing to run. If either of the other two files are
  711.         missing, appropriate error messages are issued before operation
  712.         continues. A missing help file disables on-line help. A missing
  713.         archive file can be located and mapped in directly using the
  714.         Archive Setup screen.
  715.  
  716.         Therefore, in order to effectively utilize the DOS search path
  717.         option, you must either set PALS to identify the directory
  718.         containing the ancillary files, or have copies of them in the
  719.         current directory before executing  pals . Experienced software
  720.         users will recognize the latter technique as a means of
  721.         maintaining different operating conditions for specific analysis
  722.         purposes. Most users, however, will find the former method to be
  723.         powerful and convenient when used in conjunction with
  724.         configuration kernels.
  725.  
  726.  
  727.  
  728.  
  729.  
  730.  
  731.  
  732.  
  733.  
  734.                                       2-3
  735.  
  736.         Configuration
  737.         ________________________________________________________________
  738.  
  739.         The Environment Variable PALS
  740.         -----------------------------
  741.  
  742.         One stage of file search sequences (explained in detail in the
  743.         bound manual) is controlled by the environment variable PALS.
  744.         When DataScope is not specifically directed to find a file in a
  745.         particular directory, it will default to the directory specified
  746.         in PALS before attempting to find the file in the current
  747.         directory. You can set PALS if you wish to normally direct the
  748.         file path default to a specific directory other than the current
  749.         directory. Executing  pals  in any directory will always use the
  750.         ancillary files in the PALS specified directory unless an
  751.         override pathspec is in effect (much more information is
  752.         available on overrides in the bound manual).
  753.  
  754.         Three types of ancillary files are affected by this variable,
  755.         although each is affected somewhat differently: The
  756.         configuration kernel file, the archive data file and the
  757.         PALS.HLP help file. The configuration file and archive data file
  758.         are both user specified and have topical chapters devoted to
  759.         detailed explanations in the registered version's manual. The
  760.         help file is not user specified (nor is it alterable at the
  761.         present time). DataScope will always attempt to find PALS.HLP in
  762.         the directory specified by PALS and, failing that, in the
  763.         current directory. The same holds true for the kernel and
  764.         archive files, unless a successful override supersedes the PALS
  765.         default.
  766.  
  767.         PALS is set in the AUTOEXEC.BAT file in the same manner as PATH
  768.         (it can also be set from the DOS prompt at any time). Using our
  769.         example directory, you would include this string in
  770.         AUTOEXEC.BAT:  set pals=c:\pals . Beware of the use of spaces
  771.         after the equal sign - DOS includes spaces in a variable's
  772.         specification and, if you are not careful, it is possible to
  773.         create two different variables with contents differing only by a
  774.         space. This becomes important if you later wish to remove the
  775.         PALS default while temporarily working in another directory.
  776.         Removal is accomplished by typing  set pals=  followed
  777.         immediately by a carriage return (the Enter key). DataScope will
  778.         honor both formats, so you may choose the most comfortable
  779.         syntax, but be consistent.
  780.  
  781.  
  782.         Your AUTOEXEC.BAT Contents
  783.         --------------------------
  784.  
  785.         As discussed above, you will want to include a PATH and possibly
  786.         a PALS specification in your AUTOEXEC.BAT file. Both inclusions
  787.         are elective, but recommended to increase the power of DataScope
  788.         and decrease the potential for confusion.
  789.  
  790.  
  791.                                       2-4
  792.  
  793.                                                            Configuration
  794.         ________________________________________________________________
  795.  
  796.         Your CONFIG.SYS Contents
  797.         ------------------------
  798.  
  799.         DataScope will access up to five files at one time during normal
  800.         operation. Provisions must be made in DOS to accommodate this
  801.         need by setting the number of files allowed open at once to some
  802.         number greater than five. Today's software generally demands
  803.         even more than this for database operations and other disk
  804.         intensive applications, so it is unlikely that you have not
  805.         already increased this limit. It is worth checking, however, and
  806.         to avoid problems with other applications we recommend the more
  807.         usual twenty files. Therefore, edit your current CONFIG.SYS file
  808.         to contain  files=20 .
  809.  
  810.         Also of concern as a performance issue is the number of disk
  811.         buffers DOS allocates in memory. The IBM default values for XT
  812.         and AT class machines are two and three, respectively. Everyone
  813.         knows that this is ridiculous; more useful values are ten and
  814.         twenty, respectively, unless you are using disk caching
  815.         software. Therefore, edit your current CONFIG.SYS file to
  816.         contain  buffers=10  if you are using an XT, and  buffers=20  if
  817.         you are using an AT. If you have disk caching software
  818.         installed, follow the software developer's guidelines as to the
  819.         correct number of buffers.
  820.  
  821.  
  822.         SERIAL PORT CABLING
  823.         -------------------
  824.  
  825.         DataScope is sold with a Modulink cable set but is also capable
  826.         of using cables from BreakOut-II(tm) and Serialtest(tm). More
  827.         information on the compatibility modes is available in the bound
  828.         manual delivered with registered copies of DataScope.
  829.  
  830.  
  831.         Modulink Cables
  832.         ---------------
  833.  
  834.         There are two types of Modulink cables, which can be
  835.         distinguished as the RS-232 connector and the AutoMate RJ-45
  836.         connector versions. The electrical difference between these
  837.         cables is discussed at length in the bound manual.
  838.  
  839.         Both cables are identical in that they are used for all
  840.         monitoring modes. Monitoring is a passive activity and means
  841.         that only the receive data and signal input lines of the serial
  842.         ports are active. In fact, the data transmit line is not even
  843.         connected, so interactive transmission is not possible using
  844.         either Modulink cable tap.
  845.  
  846.  
  847.  
  848.                                       2-5
  849.  
  850.         Configuration
  851.         ________________________________________________________________
  852.  
  853.            RS-232 Cable Tap (Monitor Modes)
  854.            --------------------------------
  855.  
  856.         Most likely, you will purchase DataScope with the RS-232 cable
  857.         tap. This tap has two DB-25 connectors moulded together with two
  858.         eight-wire telephone type cables exiting from the side of the
  859.         moulded hood. The ends of the eight-wire cables are terminated
  860.         with RJ-45 male plug ends, which look like large, but familiar,
  861.         RJ-11 telephone jacks. Each jack carries data and signals for a
  862.         specific side (source) of an RS-232 conversation. The source
  863.         labels are located near the RJ-45 male plug ends for easy
  864.         identification.
  865.  
  866.         These two male plugs snap securely into the two RJ-45 connector
  867.         shells supplied with the cable. The shells are source
  868.         independent; it makes no difference which shell is used on what
  869.         serial port in your computer. Each eight wire cable determines
  870.         the proper source electrically. In addition, DataScope utilizes
  871.         automatic source detection and labelling, so there is no need to
  872.         worry about which serial port carries what source unless you
  873.         have a preference or specific requirement.
  874.  
  875.         The RS-232 DB-25 connectors should easily splice the cable you
  876.         are using in your test system. The cable can be spliced into the
  877.         test system at any point in the RS-232 cable; the orientation of
  878.         the male/female connectors is completely irrelevant. If you are
  879.         interested in monitoring only one device, the tap cable can sit
  880.         on the free end of an RS-232 cable, or plug directly into the
  881.         serial port of the device under test.
  882.  
  883.  
  884.            AutoMate RJ-45 Cable Tap (Monitor Modes)
  885.            ----------------------------------------
  886.  
  887.         The RJ-45 cable tap is compatible with the extremely clever
  888.         eight-wire interlink standard called AutoMate which was
  889.         developed by ComTek Corporation. Paladin Software, Inc. is an
  890.         authorized distributor of AutoMate products; we can supply you
  891.         with literature or fill orders for this useful product that will
  892.         revolutionize (and simplify) the way we connect serial devices.
  893.  
  894.         The AutoMate Modulink cable tap operates almost identically to
  895.         its RS-232 cousin except for the lack of Ring Indicator support.
  896.         Physically, the receptacle cube contains two female RJ-45
  897.         sockets which act as a normal eight-wire splice. Like the RS-232
  898.         tap, the cube has two eight-wire telephone type cables issuing
  899.         from its side. The eight-wire cable ends are terminated with RJ-
  900.         45 male plug ends, which look like large, but familiar, RJ-11
  901.         telephone jacks. Each jack carries data and signals for a
  902.         specific side (source) of an RS-232 conversation. The source
  903.         labels are located near the RJ-45 male plug ends for easy
  904.         identification.
  905.                                       2-6
  906.  
  907.                                                            Configuration
  908.         ________________________________________________________________
  909.  
  910.         These two male plugs snap securely into the two RJ-45 connector
  911.         shells supplied with the cable. The shells are source
  912.         independent; it makes no difference which shell is used on what
  913.         serial port in your computer. Each eight-wire cable determines
  914.         the proper source electrically. In addition, DataScope utilizes
  915.         automatic source detection and labelling, so there is no need to
  916.         worry about which serial port carries what source unless you
  917.         have a preference or specific requirement.
  918.  
  919.         Unlike the RS-232 cable tap, the cube must be oriented to
  920.         connect with the proper source. The female RJ-45 receptacle
  921.         labeled DTE must be connected to the device acting as the DTE
  922.         source in the conversation. Similarly, the DCE receptacle must
  923.         connect to the DCE source. If there is no true (or known)
  924.         distinction between sources (this is quite often the case -
  925.         consider a PC, which is a DTE, connected to another PC, or a
  926.         printer) then the cube orientation is irrelevant. Cube
  927.         orientation only affects signal integrity, not data integrity or
  928.         electrical compatibility. This situation is further examined in
  929.         the Cable Type field descriptions in the bound manual.
  930.  
  931.  
  932.         Interactive Cables
  933.         ------------------
  934.  
  935.         As mentioned earlier, the passive monitor cables are not usable
  936.         for interactive transmissions since the transmit data line of
  937.         the serial ports is not connected. To utilize interactive mode,
  938.         you must connect a normal RS-232 or AutoMate cable between the
  939.         serial port you wish to transmit from and the device under test.
  940.         Interactive mode is available on both serial ports. You can
  941.         interactively transmit from either port, albeit not
  942.         simultaneously, but this will require the use of two separate
  943.         cables, or some legwork to the back of your computer to change
  944.         ports.
  945.  
  946.  
  947.  
  948.  
  949.  
  950.  
  951.  
  952.  
  953.  
  954.  
  955.  
  956.  
  957.  
  958.  
  959.  
  960.  
  961.  
  962.                                       2-7
  963.  
  964.         Configuration
  965.         ________________________________________________________________
  966.  
  967.         Shareware Cables
  968.         ----------------
  969.  
  970.         For the purposes of evaluation, it is unlikely that you will
  971.         need a monitoring cable. All functions (except true dual-sided
  972.         conversation monitoring) can be demonstrated using interactive
  973.         cables, a second computer and a little ingenuity. If you feel
  974.         that dual-sided conversation monitoring is vital, however, a
  975.         diagram showing the data connections for a dual-port monitoring
  976.         RS-232 cable is contained in the CABLE.DOC file.
  977.  
  978.         CABLE.DOC can be copied to your printer or examined with a text
  979.         editor. Connections are shown both diagrammatically and in a
  980.         pinout list. The shell to shell connections are for automatic
  981.         source detection and can be omitted if this feature is not
  982.         desired. Pinouts for both DB-25 (XT class) and DE-9 (AT class)
  983.         shells are included. For greatest utility, the RS-232 cable that
  984.         the shells tap into should have different gender connectors at
  985.         each end.
  986.  
  987.         Connections for signal information are not shown in the
  988.         CABLE.DOC diagram. Therefore, signal information will only be
  989.         valid while using the interactive mode along with a standard
  990.         RS-232 cable.
  991.  
  992.  
  993.  
  994.  
  995.  
  996.  
  997.  
  998.  
  999.  
  1000.  
  1001.  
  1002.  
  1003.  
  1004.  
  1005.  
  1006.  
  1007.  
  1008.  
  1009.  
  1010.  
  1011.  
  1012.  
  1013.  
  1014.  
  1015.  
  1016.  
  1017.  
  1018.  
  1019.                                       2-8
  1020.  
  1021.  
  1022.  
  1023.                        CHAPTER THREE - SETUP BASICS
  1024.                        ----------------------------
  1025.  
  1026.  
  1027.  
  1028.         Chapters one through three are designed to be read in sequence -
  1029.         be sure to read chapters one and two before continuing with this
  1030.         chapter. It is not necessary to implement every suggested
  1031.         enhancement in chapter two - just be aware of their impact on
  1032.         system performance.
  1033.  
  1034.         This chapter will focus on the minimum setup knowledge required
  1035.         to get DataScope doing some useful work.
  1036.  
  1037.  
  1038.         DATASCOPE HOT KEYS
  1039.         ------------------
  1040.  
  1041.         The fastest means of program control relies upon predefined Hot
  1042.         keys that directly access setup screens and directly execute
  1043.         archive functions. There are eight setup screens organized
  1044.         around related functions. Figure 3-2 contains a list of menu
  1045.         items and their related Hot key combinations, if any.
  1046.  
  1047.         Figure 3-1 contains a pocket reference listing the Hot keys and
  1048.         their related activities. Keep a copy of this page next to your
  1049.         terminal or in your pocket as a quick reference. A similar list
  1050.         can be viewed by pressing the F10 function key whenever the main
  1051.         status screen is visible.
  1052.  
  1053.  
  1054.         Hot Key Execution
  1055.         -----------------
  1056.  
  1057.         Using Hot keys is extremely simple - press and hold the Alt key
  1058.         while pressing the letter key indicated by the Hot key name.
  1059.         Release the keys in any order. Hot keys are active at all times
  1060.         (even during field editing), with one exception. The Interactive
  1061.         display requires that you specifically exit interactive mode
  1062.         using the End key before Hot keys are reactivated. Have no fear
  1063.         of Hot keys - DataScope will automatically back out of whatever
  1064.         mode, display or procedure is in progress until reaching the
  1065.         main status screen, before executing a Hot key function.
  1066.  
  1067.         Hot key activations unilaterally deactivate archiving when
  1068.         executed. There are no exceptions to this rule! Even the archive
  1069.         enabling functions (Alt-F or Freshen, Alt-E or Enable, and Alt-M
  1070.         or Match) will first terminate archiving (if in progress) before
  1071.         activating the commanded archive mode.
  1072.  
  1073.  
  1074.  
  1075.  
  1076.                                       3-1
  1077.  
  1078.         Setup Basics
  1079.         ________________________________________________________________
  1080.  
  1081.                          Setup Screen Function Keys
  1082.                          --------------------------
  1083.  
  1084.         F1  Setup screen function activation (unique to each screen).
  1085.         F2  Setup screen function activation (unique to each screen).
  1086.         F3  File viewer (Archive, Kernel, and Interactive setup
  1087.                 screens).
  1088.         F4  through  F8  are undefined.
  1089.         F9  Toggle current communications port selection on status
  1090.                 screen.
  1091.         F10 Display Quick Reference Guide when the main status screen
  1092.                 is visible.
  1093.  
  1094.                                Hot Key Summary
  1095.                                ---------------
  1096.  
  1097.         Alt-C   Capture Mode Triggering Setup screen.  Fields: Port,
  1098.                 Swing Buffers, Trigger Pattern, Chunk Size, Capturing,
  1099.                 Occurrences, Capture Count.
  1100.         Alt-A   Archive Setup screen.  Fields: Filename, Path, Drive
  1101.                 Letter, Extension Filter, Length, Chunk Size, Archiving,
  1102.                 Auto Halt.
  1103.         Alt-P   Port Parameters setup screen.  Fields: Port, Baud Rate,
  1104.                 User Baud, Parity, Stop Bits, Data Bits, RTS, DTR, OUT1,
  1105.                 OUT2, Line Break.
  1106.         Alt-T   Translation Editor screen.  Fields: Port, Character,
  1107.                 Attributes, Translation String, Mode, Number Base, Low,
  1108.                 High.
  1109.         Alt-I   Interactive File Setup screen.  Fields: Filename, Path,
  1110.                 Drive Letter, Extension Filter.
  1111.         Alt-K   Kernel File Setup screen.  Fields: Filename, Path, Drive
  1112.                 Letter, Extension Filter.
  1113.         Alt-O   Options Setup screen.  Fields: Video Mode, Control-C
  1114.                 Response, Slow Live Displays, Screen Saver Delay.
  1115.         Alt-V   Interrupt Vector Configuration screen.  Fields: Port,
  1116.                 Base Address, IRQ Number, Installed, Cable Type, Event
  1117.                 Mask, Time Stamping, Device Assignments.
  1118.         Alt-H   Context sensitive Help.
  1119.         Ctrl-C  Direct program Cancel (if enabled in the Options Setup
  1120.                 screen).
  1121.         Alt-M   Enable Match (capture) mode to trigger on the current
  1122.                 Trigger Pattern string.
  1123.         Alt-F   Activate archive mode with a Fresh archive file
  1124.                 (previous contents are lost).
  1125.         Alt-E   Enable archive mode using the current archive file
  1126.                 (retain old contents).
  1127.         Alt-D   Disable all forms of archiving regardless of the
  1128.                 initiating method.
  1129.         Alt-S   Reduce DataScope memory usage to a minimum and exit to
  1130.                 a DOS Shell.
  1131.  
  1132.                                 Figure 3-1
  1133.                          DATASCOPE POCKET REFERENCE
  1134.  
  1135.                                                             Setup Basics
  1136.         ________________________________________________________________
  1137.  
  1138.         Hot Key Mnemonics
  1139.         -----------------
  1140.  
  1141.         Each Hot key name is mnemonically devised to aid memorization.
  1142.         Here is a list of the mnemonic roots for the eight setup screen
  1143.         Hot keys, five modal Hot keys, and two function Hot keys:
  1144.  
  1145.  
  1146.            Setup Screen Hot Keys
  1147.            ---------------------
  1148.  
  1149.         Alt-C   stands for Capture and activates the Capture Mode
  1150.                 Triggering Setup screen.
  1151.         Alt-A   stands for Archive and activates the Archive Setup
  1152.                 screen.
  1153.         Alt-P   stands for Ports and activates the Port Parameters
  1154.                 screen.
  1155.         Alt-T   stands for Translations and activates the Translation
  1156.                 Editor screen.
  1157.         Alt-I   stands for Interactive and activates the Interactive
  1158.                 File Setup screen.
  1159.         Alt-K   stands for Kernels and activates the Kernel File Setup
  1160.                 screen.
  1161.         Alt-O   stands for Options and activates the Options Setup
  1162.                 screen.
  1163.         Alt-V   stands for Vectors and activates the Interrupt Vector
  1164.                 Configuration screen.
  1165.  
  1166.  
  1167.            Modal Hot Keys
  1168.            --------------
  1169.  
  1170.         Alt-M   stands for Match and enables the capture mode pattern
  1171.                 match triggering.
  1172.         Alt-F   stands for Freshen and enables a fresh archive without
  1173.                 pattern matching, destroying any previous data in the
  1174.                 archive file.
  1175.         Alt-E   stands for Enable and enables the archive append mode,
  1176.                 placing new data in the current archive file after the
  1177.                 current archive data.
  1178.         Alt-D   stands for Disable and disables whatever mode of
  1179.                 archiving or capturing is enabled, if any.
  1180.         Alt-S   stands for Shell and immediately reduces DataScope's
  1181.                 memory requirements to the minimum, and enters a DOS shell
  1182.                 with a copy of the previous environment information.
  1183.  
  1184.  
  1185.  
  1186.  
  1187.  
  1188.  
  1189.  
  1190.                                       3-3
  1191.  
  1192.         Setup Basics
  1193.         ________________________________________________________________
  1194.  
  1195.            Function Hot Keys
  1196.            -----------------
  1197.  
  1198.         Alt-H   stands for Help, and displays context sensitive help
  1199.                 from any mode.
  1200.         Ctrl-C  stands for the Control-C key combination and is
  1201.                 technically a Hot key, although its program exit function
  1202.                 is somewhat anomalous.
  1203.  
  1204.  
  1205.         DATASCOPE MENUS
  1206.         ---------------
  1207.  
  1208.         The DataScope menu line at the bottom of the screen provides
  1209.         simple, quick access to the setup screens and displays.
  1210.         Execution of a menu item can be accomplished in two ways: Press
  1211.         the first letter of any displayed menu item to instantly
  1212.         activate its function, or move the inverse cursor selection box
  1213.         (using the Left or Right arrow keys) to cover the desired menu
  1214.         item and press the Enter key.
  1215.  
  1216.         Three menu selections in the top menu level (this level is
  1217.         identified by the presence of the Quit selection on the right-
  1218.         hand side, and the absence of an Esc selection on the left-hand
  1219.         side) enter secondary menu levels containing more menu choices.
  1220.         The menu trees of these three selections are graphically
  1221.         depicted in Figure 3-2. When Hot key direct access is available
  1222.         for a particular secondary menu item, the Hot key combination
  1223.         follows the menu item name.
  1224.  
  1225.         Executing the Esc menu item in any menu level will retrace to
  1226.         the previous (parent) menu level. Only the History menu occupies
  1227.         a tertiary menu level, so unless you are in the History display,
  1228.         executing Esc will always return you to the top-level menu line.
  1229.  
  1230.  
  1231.  
  1232.  
  1233.  
  1234.  
  1235.  
  1236.  
  1237.  
  1238.  
  1239.  
  1240.  
  1241.  
  1242.  
  1243.  
  1244.  
  1245.  
  1246.  
  1247.                                       3-4
  1248.  
  1249.                                                             Setup Basics
  1250.         ________________________________________________________________
  1251.  
  1252.  
  1253.         +--------------------------------------------------------------+
  1254.         |                   Menu Command Tree                          |
  1255.         |                   -----------------                          |
  1256.         |                                                              |
  1257.         | Displays             Archive             Configure           |
  1258.         |    |                    |                    |               |
  1259.         |    +-History            +-PathSpec           +-Ports         |
  1260.         |    |    |               |    Alt-A           |    Alt-P      |
  1261.         |    |    +-GoTo          +-Triggering         +-Interrupts    |
  1262.         |    |    +-Byte Scan     |    Alt-C           |    Alt-V      |
  1263.         |    |    +-String match  +-Match (capture)    +-Translations  |
  1264.         |    |    +-Cursor        |    Alt-M           |    Alt-T      |
  1265.         |    |                    +-Freshen            +-Kernels       |
  1266.         |    +-Capture            |    Alt-F           |    Alt-K      |
  1267.         |    +-Single             +-Disable            +-Xmit files    |
  1268.         |    +-Dual               |    Alt-D           |    Alt-I      |
  1269.         |    +-Mixed              +-Enable             +-Options       |
  1270.         |    +-Alternating        |    Alt-E                Alt-O      |
  1271.         |    +-Interactive        +-Shell                              |
  1272.         |    +-Port                    Alt-S                           |
  1273.         +--------------------------------------------------------------+
  1274.  
  1275.                                  Figure 3-2
  1276.  
  1277.  
  1278.         Exiting Datascope
  1279.         -----------------
  1280.  
  1281.         There are two methods of terminating DataScope:
  1282.  
  1283.  
  1284.            Quit Menu Selection
  1285.            -------------------
  1286.  
  1287.         The top menu level contains an item named Quit. Press Q to
  1288.         activate this selection and receive a verification prompt that
  1289.         asks if you are sure you wish to exit to DOS. "Yes" is the
  1290.         default answer to this question, and you can proceed to exit by
  1291.         pressing the Enter key to accept the default, or the Y key to
  1292.         directly indicate affirmative. If you activated the Quit
  1293.         function accidentally, press any key besides Enter or Y to
  1294.         indicate that you do not wish to exit to DOS.
  1295.  
  1296.  
  1297.  
  1298.  
  1299.  
  1300.  
  1301.  
  1302.  
  1303.  
  1304.                                       3-5
  1305.  
  1306.         Setup Basics
  1307.         ________________________________________________________________
  1308.  
  1309.            Control-C Hot Key Option
  1310.            ------------------------
  1311.  
  1312.         The Ctrl-C combination offers a direct means of terminating
  1313.         DataScope from any mode within the application (except the
  1314.         Interactive display). Just as with the Alt key combinations,
  1315.         press and hold the Ctrl key while pressing the C key. Release
  1316.         the keys in any order.
  1317.  
  1318.         To enable the direct exit method, enter the Options Setup screen
  1319.         via the Options menu item in the Configuration menu (a secondary
  1320.         menu), or press Alt-O while in any mode. Edit the Control-C
  1321.         Response field to contain "Quit" using the editing procedures
  1322.         explained below.
  1323.  
  1324.  
  1325.         SETUP SCREEN FIELD EDITING
  1326.         --------------------------
  1327.  
  1328.         Probably the only text read less often than a manual is on-line
  1329.         help. But the keys to successful field editing are USING the
  1330.         Alt-H Hot key, and READING the field help bar located at the
  1331.         bottom of every setup screen.
  1332.  
  1333.         Alt-H provides context sensitive help that is cognizant of the
  1334.         active setup screen and the type of field you are attempting to
  1335.         edit. When in doubt about what to do, press Alt-H. If you are
  1336.         looking at a setup screen, and have not entered a field for
  1337.         editing when you press Alt-H, you will get help about the
  1338.         various fields and their contents. If you have actually entered
  1339.         a field for editing purposes (by pressing the letter key
  1340.         associated with the field), you will get help on the specific
  1341.         field type - what characters are expected and how to enter them.
  1342.  
  1343.         In addition, whenever you enter a field for editing, the setup
  1344.         screen field help bar changes to inform you about the field
  1345.         type, its entry methods, and legal input values.
  1346.  
  1347.  
  1348.         Field Selection
  1349.         ---------------
  1350.  
  1351.         Every setup screen uses an identical field selection technique.
  1352.         Related fields are grouped together, and every field has a
  1353.         corresponding letter. For example, the Port Parameters setup
  1354.         screen has fields lettered A through K. The letter associated
  1355.         with a field has no meaning with respect to the contents or
  1356.         function of the field - it merely identifies which letter key
  1357.         activates the editing function for that particular field. When
  1358.         you press a field's letter key (case is irrelevant), a flashing
  1359.         cursor should appear in the field or at the right-hand end,
  1360.         depending upon the type of field you have selected.
  1361.                                       3-6
  1362.  
  1363.                                                             Setup Basics
  1364.         ________________________________________________________________
  1365.  
  1366.         The presence of the flashing cursor indicates that field editing
  1367.         is in progress and, if the cursor is inside the inverse field
  1368.         box, the field location that is being edited. If the cursor
  1369.         appears outside of the inverse field box at the right hand edge,
  1370.         you have elected to edit a predefined list of choices. Lack of a
  1371.         cursor presence indicates that field selection has not occurred.
  1372.         All of these states are identified in each setup screen's field
  1373.         help bar, located in the bottom letter box.
  1374.  
  1375.         Press Esc or Enter to exit a field after completing your edits,
  1376.         or to simply leave a field without changing its contents.
  1377.  
  1378.  
  1379.         Field Entry Methods
  1380.         -------------------
  1381.  
  1382.         There are several distinct field types which expect different
  1383.         input and have specific editing methods available. All field
  1384.         types have one thing in common - they all use some subset of the
  1385.         editing function key superset (summarized below) to enter data:
  1386.  
  1387.         Home - Place the cursor at the start of the string.
  1388.         Tab - Clear (blank) the entire field and home the cursor.
  1389.         End - Place the cursor at the end of the string.
  1390.         Ins - Toggle the insert mode (an insert indicator will appear in
  1391.                 the lower right hand corner of the screen if the insert
  1392.                 mode is active).
  1393.         Del - Delete the character underneath the cursor.
  1394.         Right - Move the cursor one character to the right or revolve a
  1395.                 list of field items upward, wrapping around at the top of
  1396.                 the list.
  1397.         Left - Move the cursor one character to the left or revolve a
  1398.                 list of field items downward, wrapping around at the
  1399.                 bottom of the list.
  1400.         Up - Revolve the list of field items upward, wrapping around at
  1401.                 the top of the list. While editing a hybrid string, move
  1402.                 the cursor up into the numeric portion of the field.
  1403.         Down - Revolve the list of field items downward, wrapping around
  1404.                 at the bottom of the list. While editing a hybrid string,
  1405.                 move the cursor down into the character string portion of
  1406.                 the field.
  1407.         Backspace - Back up one character, remove it and drag the
  1408.                 remainder of the string, if any.
  1409.         Spacebar - Revolve a list of field items upward, wrapping around
  1410.                 at the top of the list.
  1411.         Enter - Accept the current string and exit the field edit mode.
  1412.                 An exit is not performed by this key when entering numeric
  1413.                 values in the hybrid string entry method. Instead, the
  1414.                 numerical character value from the numeric subfield is
  1415.                 inserted at the current cursor position in the string
  1416.                 subfield.
  1417.         Esc - Accept the current string and exit the field edit mode.
  1418.                                       3-7
  1419.  
  1420.         Setup Basics
  1421.         ________________________________________________________________
  1422.  
  1423.            Predefined Lists
  1424.            ----------------
  1425.  
  1426.         Many setup options are restricted to a predefined set of values.
  1427.         These sets are contained in revolving lists that step through
  1428.         all members of the set sequentially using the arrow keys or
  1429.         Spacebar. Up and Right revolve the lists in the upward direction
  1430.         like Spacebar, while Down and Left revolve lists downward. Enter
  1431.         and Esc both accept the currently displayed contents of the
  1432.         field and exit the field editing mode.
  1433.  
  1434.  
  1435.            Alphanumeric Strings
  1436.            --------------------
  1437.  
  1438.         String editing utilizes the broadest subset of the editing
  1439.         function keys. All keys in the above list are operational except
  1440.         Up and Down (after all, strings are not revolving lists).
  1441.         Furthermore, the revolving activities of Spacebar, Left and
  1442.         Right are not enabled - Spacebar creates a space, and both arrow
  1443.         keys move the cursor within the field of alphanumeric
  1444.         characters.
  1445.  
  1446.  
  1447.            Numeric Values
  1448.            --------------
  1449.  
  1450.         Fields that require numerical entries operate identically to
  1451.         alphanumeric strings, as far as editing is concerned. Of course,
  1452.         alpha characters are not accepted into the field, and value
  1453.         limits are occasionally imposed upon the edited result (Enter
  1454.         and Esc will beep and refuse to exit the editing mode if the
  1455.         entered value is not within the proper field limits). Whenever
  1456.         value limits are applicable they are displayed in the help bar
  1457.         during field editing.
  1458.  
  1459.  
  1460.            Hybrid Strings
  1461.            --------------
  1462.  
  1463.         In order to satisfy the need to include control characters (such
  1464.         as the codes returned by the Enter key or the Backspace key) in
  1465.         alphanumeric strings, it is necessary to offer a numeric means
  1466.         of entering individual characters into field strings. The hybrid
  1467.         string entry method addresses this requirement by presenting two
  1468.         co-active fields; one is numeric and the other is alphanumeric.
  1469.         Each subfield can be selected using the Up and Down arrow keys.
  1470.         The location of the cursor indicates which subfield is active.
  1471.  
  1472.  
  1473.  
  1474.  
  1475.                                       3-8
  1476.  
  1477.                                                             Setup Basics
  1478.         ________________________________________________________________
  1479.  
  1480.         The numeric subfield is number base sensitive (number base is
  1481.         set in the Translation Editor screen), inserting its numeric
  1482.         value into the alphanumeric subfield whenever the Enter key is
  1483.         depressed. This deviates from the normal field Enter behavior of
  1484.         accepting the current field contents and exiting the field
  1485.         editing mode. Esc retains its normal field editing behavior of
  1486.         exiting the field editing mode, regardless of the active
  1487.         subfield.
  1488.  
  1489.         The alphanumeric subfield operates exactly like a normal
  1490.         alphanumeric string field with the single addition of the Up
  1491.         arrow key, which moves the cursor into the numeric subfield
  1492.         above the alphanumeric subfield, making the numeric subfield the
  1493.         active field.
  1494.  
  1495.  
  1496.         Port Specific Fields
  1497.         --------------------
  1498.  
  1499.         The majority of fields are port-specific, which is to say that
  1500.         they contain a separate value or setting for each communications
  1501.         port. The Port field is always located in the upper left hand
  1502.         corner of setup screens. Its presence indicates that one or more
  1503.         subordinate fields are port-specific. Altering the setting of
  1504.         the Port field immediately causes any port-specific fields in
  1505.         the screen to display the correct value or setting for the
  1506.         current port. You can toggle back and forth while editing the
  1507.         Port field to see the differences between the various port-
  1508.         dependent field contents.
  1509.  
  1510.         Most setup problems involve a failure to check or setup both
  1511.         port values for a field. When only one port is in use, it is
  1512.         possible to alter the setting for the wrong port. Be sure to
  1513.         read the list of basic setup fields (presented in the next
  1514.         section and listed in Table 3-1), and check both port values for
  1515.         each field. Changing Port in one setup screen will select that
  1516.         port for the entire program. Conversely, changing the port for
  1517.         live display purposes (using the Port menu item or the F9
  1518.         function key), will also select that port for setup purposes.
  1519.  
  1520.  
  1521.         BASIC SETUP LIST
  1522.         ----------------
  1523.  
  1524.         Table 3-1 contains a list of the basic fields (and their setup
  1525.         screens) most likely to need inspection and/or alteration in
  1526.         order to tailor DataScope to your testing situation. Remember to
  1527.         edit the fields for both ports (or the correct port if you are
  1528.         only monitoring one port). The first two setup screens must have
  1529.         their fields correctly set for any monitoring to work. The last
  1530.         two setup screens must have their fields correctly set if you
  1531.         wish to perform data archiving and historic data display.
  1532.                                       3-9
  1533.  
  1534.         Setup Basics
  1535.         ________________________________________________________________
  1536.  
  1537.  
  1538.         +---------+--------------------+---------------+---------------+
  1539.         | HOT KEY |    SETUP SCREEN    |    FIELDS     |     SCOPE     |
  1540.         +---------+--------------------+---------------+---------------+
  1541.         |  Alt-P  | Port Parameters    | Baud Rate     | Port-specific |
  1542.         |         |                    | Parity        | Port-specific |
  1543.         |         |                    | Stop Bits     | Port-specific |
  1544.         |         |                    | Data Bits     | Port-specific |
  1545.         +---------+--------------------+---------------+---------------+
  1546.         |  Alt-V  | Interrupt Vector   | Installed     | Port-specific |
  1547.         |         | Configuration      | Event Mask    | Port-specific |
  1548.         |         |                    | Time Stamping | Systemic      |
  1549.         +---------+--------------------+---------------+---------------+
  1550.         |  Alt-A  | Archive Setup      | Filename      | Systemic      |
  1551.         |         |                    | Path          | Systemic      |
  1552.         |         |                    | Drive Letter  | Systemic      |
  1553.         |         |                    | Length        | Systemic      |
  1554.         +---------+--------------------+---------------+---------------+
  1555.         |  Alt-T  | Translation Editor | Mode          | Port-specific |
  1556.         |         |                    | Number Base   | Systemic      |
  1557.         +---------+--------------------+---------------+---------------+
  1558.  
  1559.                                   Table 3-1
  1560.  
  1561.         The Port Parameters must be set to agree with the communication
  1562.         parameters under test.
  1563.  
  1564.         The Installed field must show "Yes" for each port that you wish
  1565.         to be active in the monitoring process. This field controls the
  1566.         installation of port interrupt vectors. Event Mask must contain
  1567.         "Data" or "Data+Signals" to allow an interrupt to recognize and
  1568.         collect data characters only, or data characters and signal
  1569.         changes, respectively. The third setting of this field (labelled
  1570.         "Signals") only allows an interrupt to detect signal changes on
  1571.         the port channel - data is ignored. Both Installed and Event
  1572.         Mask are port-specific - set them individually for both ports.
  1573.  
  1574.         When you wish to collect a conversation in an historic archive,
  1575.         you must set the Archive Setup fields to indicate the correct
  1576.         archive file. If the file already exists in the specified
  1577.         directory (specified by the Filename and Path fields), use F1 to
  1578.         select it without alteration. If the file does not exist or you
  1579.         wish to change its Length, use F2 to select and resize, or
  1580.         create and size the file.
  1581.  
  1582.         Once you have collected data into an archive file, you can view
  1583.         it using the History display. The Translation Editor fields Mode
  1584.         and Number Base effect the method of data display. Mode
  1585.         determines whether the characters display with "ASCII" or
  1586.         "Numeric" strings. Number Base selects "Octal," "Decimal" or
  1587.         "Hex" as the current display and input number base. Mode is
  1588.         port-specific, while Number Base is systemic.
  1589.                                      3-10
  1590.  
  1591.                                                             Setup Basics
  1592.         ________________________________________________________________
  1593.  
  1594.         Device Assignments
  1595.         ------------------
  1596.  
  1597.         If you did not include the shell-to-shell connections when
  1598.         making the shareware cable, and the Device Assignments field in
  1599.         the Interrupt Vector Configuration screen is set to "Auto",
  1600.         DataScope will display ??? as source names (under the Device
  1601.         heading in the main status screen), instead of DTE and DCE (see
  1602.         Figure 3-4). Question marks will also appear in the source
  1603.         specific displays in place of the usual source names. This is
  1604.         not a malfunction, nor is it indicative of a fatal error
  1605.         condition - it merely means that DataScope has not been told
  1606.         which cable or port represents what device in the conversation.
  1607.         You can fix this situation by purchasing and/or installing the
  1608.         auto-sensing cables, or by directly specifying the device names
  1609.         with the Device Assignments field. Correct device assignment
  1610.         only has an impact upon signal integrity.
  1611.  
  1612.  
  1613.  
  1614.  
  1615.  
  1616.  
  1617.  
  1618.  
  1619.  
  1620.  
  1621.  
  1622.  
  1623.  
  1624.  
  1625.  
  1626.  
  1627.  
  1628.  
  1629.  
  1630.  
  1631.  
  1632.  
  1633.  
  1634.  
  1635.  
  1636.  
  1637.  
  1638.  
  1639.  
  1640.  
  1641.  
  1642.  
  1643.  
  1644.  
  1645.  
  1646.                                      3-11
  1647.  
  1648.  
  1649.  
  1650.                        CHAPTER FOUR - ADVANCED TOPICS
  1651.                        ------------------------------
  1652.  
  1653.  
  1654.         Because of the thoroughness with which the bound manual covers
  1655.         advanced topics, we must distill over seven chapters of
  1656.         information into this one chapter. Otherwise, this file would be
  1657.         close to half a million bytes long! As a result, the following
  1658.         treatments are often cursory, and many topics from the manual
  1659.         are not covered at all.
  1660.  
  1661.  
  1662.         HELP
  1663.         ----
  1664.  
  1665.         Alt-H will summon context sensitive help in all modes and under
  1666.         all conditions except within help itself. Help inquiries while a
  1667.         command menu is visible will explain the highlighted menu
  1668.         selection. Help inquiries within setup screens will help on the
  1669.         purpose and fields of the setup screen displayed. Help inquiries
  1670.         while editing setup screen fields will help on field editing
  1671.         procedures and the field's expected input.
  1672.  
  1673.         F10 will summon Quick Help only while the main status screen is
  1674.         visible or a live display is active (History is not considered a
  1675.         live display).
  1676.  
  1677.  
  1678.         LIVE DISPLAYS
  1679.         -------------
  1680.  
  1681.         Several live display options are available to tailor the
  1682.         screen/data view to the type of conversation under
  1683.         investigation. In general, these displays vary the format of
  1684.         source relationships to increase the ease of source
  1685.         identification. The character sets are preset with different
  1686.         attributes for each source to further distinguish sources.
  1687.  
  1688.  
  1689.         CAPTURE DISPLAY
  1690.         ---------------
  1691.  
  1692.         The capture display can be used to monitor the amount of data in
  1693.         the swing buffers and archive file. This is a real-time display
  1694.         but can also be used when there are no incoming characters.
  1695.         Certain situations of archive overrun can be detected using this
  1696.         display.
  1697.  
  1698.  
  1699.  
  1700.  
  1701.  
  1702.  
  1703.                                       4-1
  1704.  
  1705.                                                          Advanced Topics
  1706.         ________________________________________________________________
  1707.  
  1708.         HISTORY DISPLAY
  1709.         ---------------
  1710.  
  1711.         This display will show the contents of the current archive file
  1712.         (a file must be selected) with two active, timestamped cursors
  1713.         (if time stamping was enabled when the data was archived).
  1714.         Several analysis aids are available, such as GoTo, Byte Scan and
  1715.         String Match. Statistics are indicated in record numbers from
  1716.         the physical start of the archive file (even if wrap-around has
  1717.         occurred).
  1718.  
  1719.  
  1720.         History Function Keys
  1721.         ---------------------
  1722.  
  1723.         The function key operations described below are available only
  1724.         while the History display is visible. The single exception is
  1725.         the F9 port selection operation which is available at other
  1726.         times, as well. Function key operations are defined as single
  1727.         keystroke actions that are performed immediately. Menu
  1728.         selections and their activities are not included in this class
  1729.         of operations.
  1730.  
  1731.  
  1732.            History Cursor Functions
  1733.            ------------------------
  1734.  
  1735.         Two cursors (a and b) are visible whenever the history display
  1736.         is entered. Each cursor is independently operated using the Left
  1737.         and Right arrow keys. The current cursor affected by the arrow
  1738.         key functions is indicated by the inverse video box over the
  1739.         cursor letters in the upper left-hand corner of the display. You
  1740.         can toggle the current cursor selection using the F9 function or
  1741.         the Cursor menu selection. The "a" cursor is initially in the
  1742.         upper left-hand corner of the data display window, while the "b"
  1743.         cursor is initially placed in the lower right-hand corner of the
  1744.         window.
  1745.  
  1746.         NOTE: The cursors are not directly related to a specific source
  1747.         or port. Both cursors will operate on data from either port.
  1748.  
  1749.         Left arrow keystrokes will move the current cursor one data
  1750.         character left, wrapping upwards at the beginning of a line. If
  1751.         the cursor is indicating the first character in the screen when
  1752.         Left is pressed, the entire display will be redrawn from one
  1753.         character back in the data archive.
  1754.  
  1755.         Right arrow keystrokes will move the current cursor one data
  1756.         character right, wrapping downwards at the end of a line. If the
  1757.         cursor is indicating the last character in the screen when Right
  1758.         is pressed, the entire display will be redrawn from the second
  1759.         display character.
  1760.  
  1761.  
  1762.                                       4-2
  1763.  
  1764.         Advanced Topics
  1765.         ________________________________________________________________
  1766.  
  1767.         Up arrow keystrokes move the cursor up approximately one line.
  1768.         Total accuracy is not possible given the varying character
  1769.         display string lengths, so DataScope will estimate one line's
  1770.         worth of characters. If the cursor is in the top line pair of
  1771.         characters when Up is pressed, the entire display will be
  1772.         redrawn from the previous line of archive data.
  1773.  
  1774.         Down arrow keystrokes move the current cursor down approximately
  1775.         one line. Again, total accuracy is not achieved, and the cursor
  1776.         may not move exactly one line at a time. If the cursor indicates
  1777.         the last display character when Down is pressed, the entire
  1778.         display is redrawn starting from the data on the display's
  1779.         second line pair.
  1780.  
  1781.         PgUp and PgDn redraw the display using data from the previous
  1782.         and next pages of archive data, respectively. The cursors are
  1783.         placed in their default positions: The "a" cursor is placed in
  1784.         the upper left-hand corner of the screen, and the "b" cursor is
  1785.         placed in the lower right-hand corner of the screen.
  1786.  
  1787.         Home and End move the currently selected cursor to the start and
  1788.         end of the display page, respectively.
  1789.  
  1790.  
  1791.            History Special Functions
  1792.            -------------------------
  1793.  
  1794.         F1 and F2 cooperate to calculate the effective baud rate (which
  1795.         is a measure of line utilization) on the inclusive data between
  1796.         the two cursor positions (technically, only one end point is
  1797.         included in the calculation of the number of characters, e.g.
  1798.         selecting adjacent characters is indicative of one data
  1799.         character transmitted during the inter-character gap). F1
  1800.         calculates the effective baud rate based upon the number of
  1801.         characters between the two cursors, the data rate and UART
  1802.         parameters (number of data bits, stop bits, parity bits) at the
  1803.         time of the archive storage, and the F2 selection. F2 selects
  1804.         either one or both of the data sources for inclusion in the
  1805.         calculation of the number of characters when determining the
  1806.         effective baud rate.
  1807.  
  1808.         F9 functions identically to the Cursor menu selection, toggling
  1809.         the current data cursor selection. The new selection is
  1810.         indicated by the inverse cursor box over the "a" or "b" cursor
  1811.         letters in the upper left-hand corner of the screen.
  1812.  
  1813.  
  1814.  
  1815.  
  1816.  
  1817.  
  1818.  
  1819.  
  1820.  
  1821.                                       4-3
  1822.  
  1823.                                                          Advanced Topics
  1824.         ________________________________________________________________
  1825.  
  1826.         History Menu Selections
  1827.         -----------------------
  1828.  
  1829.         More complex activities that require setup and initialization,
  1830.         such as search functions, are accessed from menu selections.
  1831.         Both port dependent and port independent searches are available.
  1832.         The menu items act identically to normal menu items, vis-a-vis
  1833.         first letter selection and use of the arrow and Enter keys.
  1834.  
  1835.  
  1836.            GoTo
  1837.            ----
  1838.  
  1839.         Often it is necessary to reference a data byte location for
  1840.         future examination. The lower left-hand corner of the display
  1841.         contains "a" and "b" cursor record numbers in the status line
  1842.         box. As you move the cursors, these record numbers are
  1843.         automatically updated, which, in conjunction with the GoTo
  1844.         function, provide a simple means of returning to a particular
  1845.         byte location in the archive.
  1846.  
  1847.         Activating the GoTo function enters the character position entry
  1848.         field screen. Instructions in the status line box include the
  1849.         upper and lower limits of the current archive's record numbers.
  1850.         Numerical entry of the record number (position) is expected in
  1851.         decimal regardless of the current number base (record numbers
  1852.         are always tracked in decimal for simplicity).
  1853.  
  1854.         After entering a valid record number, press Enter to activate
  1855.         the GoTo function. The entry screen will be replaced by the
  1856.         original History display, and the data window will be rewritten
  1857.         with data starting from the requested position. Esc will exit
  1858.         the entry field and entry screen without activating the GoTo
  1859.         function (in case you change your mind after activating the GoTo
  1860.         setup screen).
  1861.  
  1862.  
  1863.            Byte Scan
  1864.            ---------
  1865.  
  1866.         The byte scan mechanism is port independent, which means that
  1867.         the current port selection does not influence the scan. Data
  1868.         from both ports is scanned for the correct value, and the first
  1869.         "hit" is used as the new History display starting point. The
  1870.         scan will wrap around the end of the archive file and continue
  1871.         until a character is found, or until one complete scan of the
  1872.         data has been performed. A scan in progress can be aborted at
  1873.         any time by pressing Esc.
  1874.  
  1875.         Activate the Byte scan menu entry to alter the character value
  1876.         sought by the scan mechanism. Entry is always in the current
  1877.         number base, and the character display string is echoed below
  1878.         the entry field to verify (in the case of special or unprintable
  1879.         ASCII codes) the desired value.
  1880.                                       4-4
  1881.  
  1882.         Advanced Topics
  1883.         ________________________________________________________________
  1884.  
  1885.         Press Enter after editing the string to activate the scan. The
  1886.         entry screen will be replaced by the original History display,
  1887.         and if the character is found, the data window will be re-
  1888.         written from the newly found data byte. Esc will terminate the
  1889.         field entry mode and close the entry screen without activating
  1890.         the data character scan function, allowing a penalty free exit.
  1891.  
  1892.  
  1893.            String Match
  1894.            ------------
  1895.  
  1896.         String matching is a port-specific function, which means that
  1897.         the current port at the time you activate the String match
  1898.         function determines:
  1899.  
  1900.                 a) The previous string search data (the search data for
  1901.                 each port is memorized to allow repeated searching). In
  1902.                 other words, the contents of the string match entry field.
  1903.  
  1904.                 b) The port (source) data to search for the next
  1905.                 occurrence of the search string. String matching searches
  1906.                 the data from one specific source, even if data is present
  1907.                 and interleaved from both ports.
  1908.  
  1909.         The search will wrap around the end of the archive file and
  1910.         continue until a match is found, or until one complete scan of
  1911.         the data has been performed. A search in progress can be aborted
  1912.         by pressing Esc. When a match is found, the display is re-
  1913.         written from the first byte in the matching string. The current
  1914.         cursor is forced to the "a" cursor to prevent inadvertent motion
  1915.         of the "b" cursor from scrolling the display.
  1916.  
  1917.         Activate the String match menu entry to input the search string.
  1918.         Entry is accomplished with the divided hybrid entry method to
  1919.         allow a string of any binary values. Use the Up and Down arrow
  1920.         keys to select the entry method, and edit the string to contain
  1921.         the desired values.
  1922.  
  1923.         The upper hybrid subfield will allow numeric entry in the
  1924.         current number base. Press Enter while in this subfield to place
  1925.         the numeric field equivalent into the string at the current
  1926.         string subfield cursor position (denoted by the display arrow).
  1927.         Press Enter while in the string subfield, to accept the current
  1928.         string and initiate the search function. Esc will terminate
  1929.         either hybrid entry mode and close the String match entry screen
  1930.         without activating the string search function.
  1931.  
  1932.  
  1933.  
  1934.  
  1935.  
  1936.  
  1937.  
  1938.  
  1939.                                       4-5
  1940.  
  1941.                                                          Advanced Topics
  1942.         ________________________________________________________________
  1943.  
  1944.         PORT SETUP
  1945.         ----------
  1946.  
  1947.         Remember to keep OUT2 "Asserted" to enable interrupts on IBM
  1948.         compatible adapters. A summary of the port settings appears in
  1949.         the main status screen and the Port Parameters setup screen.
  1950.  
  1951.         Baud rates can be set in two ways. Standard rates are set in the
  1952.         Baud Rate field. One of the standard selections is User, which
  1953.         activates the User Baud field. Input the non-standard rate you
  1954.         desire and it will automatically be forced to the NEAREST actual
  1955.         baud rate supported by the hardware.
  1956.  
  1957.  
  1958.         VECTOR SETUP
  1959.         ------------
  1960.  
  1961.         DataScope comes pre-configured to utilize the normal Com1 and
  1962.         Com2 interrupt vectors and base addresses. The Interrupt Vector
  1963.         Configuration setup screen allows alteration of the defaults as
  1964.         well as other interrupt related options. Be extremely careful
  1965.         when altering the Base Address or IRQ Number fields - incorrect
  1966.         setup could cause a system crash! NOTE: If you inadvertently
  1967.         crash the system, reboot and execute pals with an interrupt
  1968.         disable switch (-I, -i, /I, and /i will all work). This will
  1969.         prevent interrupt installation to allow correction of the Base
  1970.         Address and/or IRQ Number fields.
  1971.  
  1972.         Cable Type selection will depend upon the type of monitoring you
  1973.         do and your personal preference for cabling options. For
  1974.         interactive connections (regardless of the cable system used)
  1975.         select Interactive. If you are using a cable you manufactured
  1976.         following the CABLE.DOC diagram, use the Modulink selection.
  1977.  
  1978.         Choose the Event Mask based upon the information that interests
  1979.         you. This selection must be made for each port. "Data+Signals"
  1980.         is a safe bet for most applications, but you can reduce overhead
  1981.         for high-throughput conditions by selecting "Data" (the
  1982.         interrupt routines are replaced at the vector level to avoid
  1983.         testing overhead and maximize efficiency). "Signals" will accept
  1984.         signal changes (cable dependent) from the respective port but
  1985.         ignore data.
  1986.  
  1987.         Time stamps can be enabled or disabled. Preventing time stamping
  1988.         has two effects - reduced overhead (once again, interrupts are
  1989.         replaced at the vector level to eliminate testing overhead) and
  1990.         increased storage capacity of the archive files (by a factor of
  1991.         two). We recommend using time stamps whenever possible, however,
  1992.         as they are extremely useful.
  1993.  
  1994.  
  1995.  
  1996.  
  1997.  
  1998.                                       4-6
  1999.  
  2000.         Advanced Topics
  2001.         ________________________________________________________________
  2002.  
  2003.         Device Assignments can be forced or read from the smart cables
  2004.         (Modulink and Serialtest). BreakOut-II requires Com1=DCE and
  2005.         Com2=DTE.
  2006.  
  2007.  
  2008.         ARCHIVE SETUP
  2009.         -------------
  2010.  
  2011.         Archive files can be created, selected, reused, re-sized and
  2012.         viewed from disk. The important distinction to keep in mind is
  2013.         the difference between F1 and F2. Function F1 will select a
  2014.         previously created and/or used file as the current file. The
  2015.         file's original length will be used regardless of the Length
  2016.         field contents. F2 will re-size the selected file to the value
  2017.         contained in the Length field. Both functions create files (if
  2018.         you wish) that cannot be found as specified using the Length
  2019.         field to determine the new file's length.
  2020.  
  2021.         Read the Technical Information section in the third page of the
  2022.         Archive Setup help screens for information on setting the Chunk
  2023.         and Length fields.
  2024.  
  2025.  
  2026.         CAPTURE SETUP
  2027.         -------------
  2028.  
  2029.         In order to capture specific data, complete the following
  2030.         necessary steps before initiating the data capture mode.
  2031.  
  2032.           I.  Insure that there is a current archive file. The filespec
  2033.                 is displayed in the main status screen and the Archive
  2034.                 Setup screen.
  2035.          II.  Enter a Trigger Pattern in the Capture Mode Triggering
  2036.                 Setup screen for the source port of interest. Verify that
  2037.                 the length is correct after entering the string text.
  2038.         III.  Set Occurrences for the number of Trigger Patterns you
  2039.                 wish to detect before entering the Capture Count
  2040.                 countdown.
  2041.          IV.  Set Capture Count to the number of chunks to archive
  2042.                 after receipt of the final occurrence of the Trigger
  2043.                 Pattern.
  2044.           V.  Set the Chunk Size to the size desired (keeping in mind
  2045.                 the archive Length, Capture Count value, and the
  2046.                 situation's data rates and throughput).
  2047.          VI.  Increase the number of Swing Buffers to the maximum
  2048.                 supported by your available memory.
  2049.  
  2050.  
  2051.  
  2052.  
  2053.  
  2054.  
  2055.  
  2056.  
  2057.                                       4-7
  2058.  
  2059.                                                          Advanced Topics
  2060.         ________________________________________________________________
  2061.  
  2062.                               FUNCTION CONTROL
  2063.                               ----------------
  2064.  
  2065.  
  2066.         DATA ARCHIVE
  2067.         ------------
  2068.  
  2069.         Once an archive file is specified, the archiving process is
  2070.         quite simple. There are several ways to initiate archiving and
  2071.         many archiving options. To initiate an archive:
  2072.  
  2073.           I.  Press Alt-F to freshen the archive (overwriting old data).
  2074.          II.  Press Alt-E to enable the archive (appending new data to
  2075.                 the contents of the archive file).
  2076.         III.  Select Freshen or Enable from the Configuration menu line
  2077.                 (functionally equivalent to the Hot keys Alt-F and Alt-E,
  2078.                 respectively).
  2079.          IV.  Edit the Archiving field in the Archive Setup screen to
  2080.                 Enabled and exit the Archive Setup screen.
  2081.  
  2082.         One special feature deserves mention. Archive enable is designed
  2083.         to allow taking a snapshot of the contents of the swing buffers
  2084.         without constantly running the archive in the background. All
  2085.         data in the buffers will be saved to the archive if the archive
  2086.         is completely empty. Newly created archives are empty as are
  2087.         archives that have been freshened and disabled without receiving
  2088.         characters during the two operations.
  2089.  
  2090.  
  2091.         DATA CAPTURE
  2092.         ------------
  2093.  
  2094.         Data capture can be started up in three ways, all of which are
  2095.         analogous to the archive start up methods:
  2096.  
  2097.           I.  Press Alt-M to initiate the match (capture) mode.
  2098.          II.  Select Match (capture) from the Configuration menu line,
  2099.                 which is functionally equivalent to the Hot key Alt-M.
  2100.         III.  Edit the Capturing field in the Capture Mode Triggering
  2101.                 Setup screen to Enabled and exit the Capture Mode
  2102.                 Triggering Setup screen.
  2103.  
  2104.         Capture mode always clears the old data from a used archive
  2105.         file. The port that is current at the time capturing is enabled
  2106.         determines which port's Trigger Pattern is used as the trigger
  2107.         definition.
  2108.  
  2109.  
  2110.  
  2111.  
  2112.  
  2113.  
  2114.  
  2115.  
  2116.                                       4-8
  2117.  
  2118.         Advanced Topics
  2119.         ________________________________________________________________
  2120.  
  2121.         TRANSLATION STRING EDITING
  2122.         --------------------------
  2123.  
  2124.         Editing procedures are discussed separately, but functions can
  2125.         be combined. For example, attribute and string editing can occur
  2126.         in the same session, but will be discussed individually for
  2127.         maximum clarity.
  2128.  
  2129.         While following the step by step procedures for each type of
  2130.         alteration, keep in mind that the changes instituted will apply
  2131.         only to the character set currently selected. Each of the twelve
  2132.         character sets are identified by the contents of the Port/Number
  2133.         Base/Mode fields.
  2134.  
  2135.  
  2136.         Individual Attribute Changes
  2137.         ----------------------------
  2138.  
  2139.         It is a very simple matter to replace an attribute for any given
  2140.         character in a particular set. Follow this entire procedure for
  2141.         each character attribute you wish to modify:
  2142.  
  2143.         o Edit the Character field to contain the Octal, Decimal or
  2144.                 Hexadecimal (depending upon the current Number Base)
  2145.                 numeric value of the character whose attribute you wish to
  2146.                 change. All three digits in the field are considered to
  2147.                 make up the requested value - the position of the cursor
  2148.                 at the time editing is concluded is irrelevant.
  2149.  
  2150.         o Exit the Character editing mode to update the Attributes
  2151.                 field.
  2152.  
  2153.         o Edit the Attributes field to contain the numeric value of the
  2154.                 desired attribute. As with the Character field entry, the
  2155.                 final cursor position is not relevant to the entered
  2156.                 value. DataScope will assume all three digits are part of
  2157.                 the number.
  2158.  
  2159.         o Exit the editing mode for the Attributes field.
  2160.  
  2161.         o Press the F1 function key to update the attribute of the
  2162.                 selected character and its translation string.
  2163.  
  2164.  
  2165.  
  2166.  
  2167.  
  2168.  
  2169.  
  2170.  
  2171.  
  2172.  
  2173.                                       4-9
  2174.  
  2175.                                                          Advanced Topics
  2176.         ________________________________________________________________
  2177.  
  2178.         Translation String Changes
  2179.         --------------------------
  2180.  
  2181.         Follow this entire procedure for each character translation
  2182.         string you wish to modify:
  2183.  
  2184.         o Edit the Character field to contain the Octal, Decimal or
  2185.                 Hexadecimal (depending upon the current Number Base)
  2186.                 numeric value of the character whose translation string
  2187.                 you wish to alter. All three digits in the field are
  2188.                 considered to make up the requested value - the cursor
  2189.                 position at the time editing is concluded is irrelevant.
  2190.  
  2191.         o Exit the Character editing mode to update the Translation
  2192.                 String field.
  2193.  
  2194.         o Edit the Translation String field to contain the alphanumeric
  2195.                 values desired in the new translation string. As with the
  2196.                 Character field entry, the final cursor position is not
  2197.                 relevant to the entered value. DataScope will assume all
  2198.                 alphanumeric characters are part of the string, so do not
  2199.                 leave extraneous characters after the cursor - make sure
  2200.                 the cursor is followed by blanks (spaces). Following
  2201.                 spaces are not included in the string, but leading spaces
  2202.                 are incorporated as part of the string.
  2203.  
  2204.         o Exit the editing mode for the Translation String field.
  2205.  
  2206.         o Press the F1 function key to update the translation string of
  2207.                 the selected character.
  2208.  
  2209.  
  2210.         Global Attribute Changes
  2211.         ------------------------
  2212.  
  2213.         o Edit the Low and High fields to define the inclusive range
  2214.                 of characters whose attributes you wish to set. As with
  2215.                 most numeric fields, the final cursor position does not
  2216.                 matter - all numbers in the field are assumed to be part
  2217.                 of the final value.
  2218.  
  2219.         o Edit the Attributes field to contain the desired attribute
  2220.                 value. Again, the cursor does not determine how many
  2221.                 characters are in the field.
  2222.  
  2223.         o Press the F2 function key to alter the attributes of all
  2224.                 characters from Low, up to and including, High.
  2225.  
  2226.  
  2227.  
  2228.  
  2229.  
  2230.                                      4-10
  2231.  
  2232.                              Appendix A
  2233.                              ----------
  2234.  
  2235.         Paladin Software, Inc. is a member of the Association of
  2236.         Shareware Proffesionals (ASP). ASP wants to make sure that
  2237.         the shareware principle works for you. If you are unable to
  2238.         resolve a shareware-related problem with an ASP member by
  2239.         contacting the member directly, ASP may be able to help. The
  2240.         ASP Ombudsman can help you resolve a dispute or problem with an
  2241.         ASP member, but does not provide technical support for members'
  2242.         products. Please write to:
  2243.  
  2244.                            ASP Ombudsman
  2245.                            545 Grover Road
  2246.                            Muskegon, MI  49442
  2247.  
  2248.         or send a Compuserve message via easyplex to:
  2249.  
  2250.                            ASP Ombudsman
  2251.                            70007,3536
  2252.  
  2253.  
  2254.                              Appendix B
  2255.                              ----------
  2256.  
  2257.         Two types of files are present in the shareware product version:
  2258.         Files that are necessary for DataScope operation, and shareware
  2259.         documentation files. Both groups are listed below for reference.
  2260.         All files in both groups should be present on the disk or in the
  2261.         compressed file, depending upon how you received DataScope.
  2262.  
  2263.  
  2264.                               Operational Files
  2265.                               -----------------
  2266.  
  2267.                 PALS.EXE         DataScope executable file.
  2268.                 PALS.CFG         Default configuration kernel file.
  2269.                 EBCDIC.CFG       Alternate EBCDIC character translations.
  2270.                 COLORS.CFG       Demonstration character attribute colors.
  2271.                 PALS.HLP         On-line, context sensitive help file.
  2272.  
  2273.                 SEQUENCE.BIN     Demonstration archive file.
  2274.                 SEQUENCE.DAT     Demonstration interactive transmission
  2275.                                  file.
  2276.  
  2277.  
  2278.                              Documentation Files
  2279.                              -------------------
  2280.  
  2281.                 MANUAL.TXT       Shareware manual text file.
  2282.                 CABLE.DOC        Shareware cable description file.
  2283.                 ORDERFRM.DOC     Registered version order form.
  2284.                 README.TXT       This file contains the most recent
  2285.                                  DataScope product information.